This month's disc features a subject-based index (roughly corresponding to the subject areas of the New Inside Macintosh series) similar to that introduced on September's Reference Library CD. Within each subject folder you will find DocViewer collections and aliases to all material on the disc having to do with that subject. Feedback, as always, is welcome; send your comments to AppleLink DEV.CD or to dev.cd@applelink.apple.com.
In addition to updates to the Developer Notes, Technotes, and Newton sample code, here are this month's new and revised packages.
AE Suite • Finder: The Finder suite contains definitions of the Apple
events and other Apple event constructs understood by the Finder. This document
supercedes the information provided in Chapter 8 of the Apple event registry.
The old Finder suite was developed before the Apple Event Manager and the Apple
Event Object Support Library were complete. As a result, it did not support
Apple event objects or the Core Apple events. The events defined in the old
Finder suite are still provided for backwards compatability with existing
applications; the event class of events defined in the old suite is
kAEFinderEvents. Because the old Finder suite does not take advantage of the
current capabilities of Apple events, applications that wish to control the
Finder should always use the new event suite described in this document.
Apple Bug Reporter 1.6: The Apple Bug Reporter is a HyperCard stack
that allows developers to report bugs against Macintosh software and hardware.
When you have completed a bug, the stack puts it in your AppleLink Out Basket.
When you next log on to AppleLink, your bug is sent to APPLE.BUGS.
The Apple Bug Reporter 1.6 is an upgrade to version 1.5 that updates the
information in configurations (added new Macintosh and monitor models), adds some
components and makes some minor interface enhancements. Of course, there are also
some bug fixes.
Apple Guide Authoring Kit: The contents of this folder are provided to
developers for their use in creating guide files for use with Apple Guide and
System 7.5. Please read the License Agreement before using any of the items in
this kit.
Apple Guide marks a leap from the passive assistance of typical help systems to
on-line active assistance that lets users accomplish tasks as they learn how to
do them. Rather than read through a manual or browse the built-in "help" of an
application (which is typically little more than a manual on disk), users can
call on Apple Guide technology and be walked through the solution to their
problem simply by following a series of on-screen prompts. It's almost like
having a local expert look over your shoulder and guide you through the task at
hand.
Features: With the Guide Maker 1.0 authoring tool provided in this folder you
can write your own guides to walk a user through the applications they already
have on their Macintosh. Write your content in the word processor of your
choice, then use Guide Maker to compile your content into an Apple Guide file.
Then, simply drop the guide in the folder of the application you wish to coach,
and -- voila! - -you've just brought Apple Guide's amazing abilities to bear on
your users' most frequently asked questions.
Also included in this folder is full, on-line documentation for Guide Maker 1.0
and the Guide Script command language, as well as convenient guide authoring
aides like Coach Mark Assistant, a tool that makes specifying coach marks as easy
as drawing them on-screen.
AppleSearch Client SDK Overview: This package provides Developers with
information on how to create or develop products using or to be used with
AppleSearch. It contains two documents:
• AppleSearch Developer's Kit Overview
• AppleSearch Update File Format Reference
Developers need to sign the AppleSearch Developer's License for using
and distributing AppleSearch.
AppleTalk and PPP: This package includes the draft specifications for
running AppleTalk over the Point-to-Point Protocol. If you want to implement
AppleTalk running over the Point-to-Point Protocol you should follow these
specifications as they are standardized in the Internet Engineering Task Force.
BBEdit Lite 3.0: BBEdit Lite is a freeware derivative of BBEdit 3.0, the popular and
critically acclaimed text editor for programmers, on-line-service users, and anyone
else who needs to edit plain-text files.
BBEdit Lite is shipped with a QuickStart document which describes many
of the application’s features. Full documentation, as well as a
considerable amount of additional functionality, is available with the
purchase of BBEdit 3.0. See the document “BBEdit General Information”
for details on obtaining BBEdit 3.0.
Issues: This is NOT AN APPLE PRODUCT. It is provided on an AS-IS basis. Apple is
not responsible for any problems you may encounter in its use.
Dylan Related: This folder contains imformation and sample code
pertaining to the Dylan programming language.
•Dylan Interim Manual: This directory contains the June 1994 interim Dylan
language reference.
• Dylan FAQ 29July94: Answers to Frequently Asked Questions about Dylan, a new
object-oriented dynamic programming language (OODL) developed at Apple. Includes
info about mailing lists and places to get sample code, implementations, and
further information.
• newsletter #1, 29Jul94: A brief newsletter with some Dylan news, includes the
FAQ
• Dylan WWDC'94 brochure: A two-page brochure describing the Apple Dylan
environment distributed at the Apple World Wide Developers Conference in May 1994
by Apple. This document was created with Common Ground so you don't need the
original fonts or applications. On Mac, just double-click to view. Viewers for
Windows or Unix are also available - contact NOHANDS@applelink.apple.com.
• MacMarlais-0.3.1.sea: This is the latest Macintosh version of Marlais, a
freeware interpreter for Dylan. Version 0.3.1 still supports the old lispy
syntax. A new version, 0.5 is available for Unix and Windows, and the Mac version
will be released in the next week or so.
• Marlais 0.5 (sources only): Source code (in C) for Marlais, a freeware
interpreter for Dylan. This supports the newer infix (algebraic) syntax.
• Marlais-0.5 for Windows.zip: A Windows port of Marlais, a freeware interpreter
for Dylan. This supports the newer infix (algebraic) syntax.
• Mindy-1.1 (sources only): Source code (in C) for Mindy, a freeware byte-code
compiler for Dylan. This supports the newer infix (algebraic) syntax, and has
been compiled for several implementations of Unix, but no version for Mac or
Windows has been released yet.
•Thomas 1.1/Gambit 2.0: This is an *experimental* implementation of Dylan, the
exciting new object-oriented dynamic language (OODL) from Apple. Thomas is
implemented in Scheme, and runs on many Schemes on many platforms. In particular,
we include a standalone Thomas interpreter for the Mac based on Gambit, a
freeware Scheme for Macintosh (and 680x0 unix boxes).
File System Manager SDK: The File System Manager provides a systematic
way for one or more foreign file systems to interact with the Macintosh file
system using high-level language interface.
Features:
• File System Manager -- A system extension which implements version 1.2 of FSM
and the extended Disk Initialization Package. This extension is compatible with
System 7.0 and later.
• FSMGlueLib.o -- The glue code for the File System Manager service routines.
• FSM.h. FSM.p and FSM.a -- The Universal Interface files for the File System
Manager. This version of the interface files was built to work with the Universal
Interfaces 2.0a1 from ETO #15, MPW prerelease. However, for 68K development,
FSM.h works perfectly with the current release of Universal Interfaces on ETO
#15.
• Guide - File System Manager -- The documentation for the File System Manager in
Apple DocViewer format.
The File System Manager extension may be licensed for distribution from
Apple Software Licensing.
Installer 4.0.3 SDK: Installer 4.0.3 provides the latest Apple
technology for installing and upgrading software to both 68K and Power PC based
Macintosh systems.
Version 4.0.3 is a bug fix release of the Apple multi-disk installer which also
offers the new InstaCompOne decompression atom extender. The documentation has
also been revised to go into greater detail towards addressing common questions
and issues which were raised with Installer v4.0.
Macintosh Common Lisp Utilities: This folder includes the latest patches and interface
files for users of MCL (Macintosh Common Lisp). This is a maintenence release,
with some bug fixes and support for MCL on newer Macintosh platforms such as the
QuadraAV series. If you currently have MCL 2.0, the enclosed files will update
you to 2.01. In addition, there are tutorials and discussions of various
Lisp-related topics.
Newton Sample Code 1.2: This folder contains Newton Q&A documents (in
both DocViewer and Microsoft Word formats); sample code compatible with the
Newton MessagePad, Newton MessagePad 100 and 110, and Sharp ExpertPad; and
several articles on Newton development. Each Newton project includes a text file
containing the project’s source code (for curious programmers who don’t have the
Newton Toolkit).
PCCTS: PCCTS (The Purdue Compiler-Construction Tool Set) is a public
domain tool set consisting of a parser generator called ANTLR and a lexical
analyzer called DLG. ANTLR accepts a grammatical description for an input
language and generates a recursive-descent parser in C or C++ to recognize
sentences in that input language; DLG is used to break up the input stream of
characters into a token stream.
ANTLR combines the flexibility of hand-coded parsing with the convenience of a
parser generator. ANTLR has many features that make it easier to use than other
language tools. Most important, ANTLR provides PREDICATES which let the
programmer systematically direct the parse via arbitrary expressions using
semantics and syntactic context; in practice, the use of predicates eliminates
the need to hand-tweak the ANTLR output, even for difficult parsing problems.
ANTLR also integrates the description of lexical and syntactic analysis, accepts
LL(k) grammars for k>1 with extended BNF notation, and can automatically generate
abstract syntax trees.
RAMDisk sample: This folder contains a sample RAMDisk written in C. It can be compiled
using MPW, Symantec, or Metrowerks.
Features: Shows how to integrate an INIT, CDEV, and DRVR in one package. Shows
how to generate code using multiple development environments. Demonstrates some
proper techniques for driver installation.
ResEdit 2.1.3: ResEdit is Apple's standard direct-manipulation resource
editing and creation tool. See the "About ResEdit 2.1.3" file within the
"ResEdit 2.1.3" folder for a list of new features and bug fixes in this release.
ShrinkWrap™ 1.1: ShrinkWrap is a utility to create and mount DiskCopy
images. It will also mount DART disk images and can utilize the StuffIt™ Engine
for compression. See the file "ShrinkWrap™ Read Me" for more information.
Please note that this is NOT AN APPLE PRODUCT. It is provided on an AS-IS basis. Apple is
not responsible for any problems you may encounter in its use.
Snippets - AOCE: New and revised Snippets include:
• Construct AOCE Address: Creates an AOCE packedDSSpec structure representing
the address of the mailbox of the machine that it is running on. This could then,
for example, be passed to SMPResolveToRecipient to create a mail address for the
given machine.
• Create AOCE Business Card: Shows how to create a PowerTalk business card
anywhere on a given volume. Just create an FSSpec and call CreateBusinessCard()
with that FSSpec.
• DragBusinessCard: This program shows how to accept drags of
flavorTypeDirectory and flavorTypeHFS for a PowerTalk business card, and drags
from the application to the Finder to create generic clippings that contain an
empty packedDSSpec structure.
Snippets - Networking: New and revised Snippets include:
• ADSP Chat: ADSP Chat is a sample application demonstrating the use of the
AppleTalk Data Stream Protocol (ADSP).
Snippets - Processes: New and revised Snippets include:
• LaunchWithDoc2: Document-launching sample program Loosely based on C.K. Haun's
LaunchWithDoc. This snippet includes some very useful routines.
Snippets - Sound: New and revised Snippets include:
• MeterTest: This snippet demonstrates record metering through the use of
SPBGetDeviceInfo() and SPBSetDeviceInfo() using the siLevelMeterOnOff selector.
Snippets - Toolbox: New and revised Snippets include:
• ColoredCheckBox: This app demonstrates how to create a check box on a gray
window background. The key to this is making sure that the background color for
the window is set.
• GetDragHiliteColor: This shows how to obtain the color that the Drag Manager
uses to hilite regions when ShowDragHilite is called. Please note this is only
how it's done presently. Since it is undocumented it can and will change in the
future.
• GridWindowGrow: This snippet shows how to grow a window constrained to a grid
(i.e. only allow a window to grow or shrink by 30 pixels, or whatever).
SpriteWorld 1.0b4: SpriteWorld is a sprite-based animation
architecture for the Macintosh. SpriteWorld comes as a set of code libraries and
interfaces that provide a simple, but deep programming interface for implementing
smooth, fast, animation in your applications. In the interest of openness and
learning, the full source code to the SpriteWorld libraries and sample
applications is provided. SpriteWorld was designed for arcade game style
animation in particular with full support for multi-frame, overlapping, animated
sprites, and custom pixel-blitting routines. See the file "SpriteWorld Read Me"
for details.
Next Month: Practically everything in the known universe (including develop magazine articles) in subject-based DocViewer collections, new Developer Notes and Technotes, and more.
